/*
 * Copyright (c) 2022-present Charles7c Authors. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package top.continew.admin.card.service;

import top.continew.admin.card.model.query.BusinessCardVisitorRecordQuery;
import top.continew.admin.card.model.req.BusinessCardVisitorRecordReq;
import top.continew.admin.card.model.resp.BusinessCardVisitorRecordDetailResp;
import top.continew.admin.card.model.resp.BusinessCardVisitorRecordResp;
import top.continew.admin.card.model.resp.CardVisitorResp;
import top.continew.admin.card.model.resp.VisitorStatisticsRep;
import top.continew.starter.extension.crud.service.BaseService;

import java.util.List;

/**
 * 微信名片访问记录业务接口
 *
 * @author floyd
 * @since 2024/12/02 15:48
 */
public interface BusinessCardVisitorRecordService extends BaseService<BusinessCardVisitorRecordResp, BusinessCardVisitorRecordDetailResp, BusinessCardVisitorRecordQuery, BusinessCardVisitorRecordReq> {

    /**
     * 根据微信名片ID获取访问信息统计
     *
     * @param cardId 名片ID
     * @return 微信名片访问信息统计
     */
    Integer getCountByCardId(Long cardId);

    /**
     * 根据微信名片ID获取访客信息列表
     *
     * @param cardId 名片ID
     * @return 访客信息列表
     */
    List<CardVisitorResp> getCardVisitorListByCardId(Long cardId, Integer number);

    VisitorStatisticsRep getVisitorPraise(Long cardId, Integer number);
}